home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 751-760 / 759 / azap / azap.doc < prev    next >
Text File  |  1995-03-18  |  16KB  |  376 lines
  1.  
  2.                AZap - Manuel de référence
  3.  
  4.  
  5.  
  6.  
  7.  
  8.   1. Avertissement
  9.  
  10.       Ce manuel décrit la version 1.00 de l'utilitaire AZap. Ce  programme
  11.   est (c)1992 par Denis GOUNELLE, toute utilisation commerciale ou vente  sans
  12.   autorisation    écrite    est  strictement  interdite.  Vous  pouvez  copier  et
  13.   diffuser ce programme aux conditions suivantes :
  14.  
  15.     - l'ensemble des fichiers doit être fourni
  16.     - aucun fichier ne doit avoir été modifié
  17.     - vous ne devez pas demander plus de 40FF pour cela
  18.  
  19.       Malgré de nombreux tests, je ne peux garantir  qu'AZap  ne  contient
  20.   aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES  ET  PERILS.    Je  ne
  21.   pourrai en aucun cas être tenu pour responsable de tout dommage,  direct  ou
  22.   indirect, résultant de l'utilisation d'AZap.
  23.  
  24.   2. Introduction
  25.  
  26.       AZap est un éditeur binaire "nouvelle génération", capable  d'éditer
  27.   aussi bien un fichier que la mémoire, ou encore  une    disquette  (même  s'il
  28.   n'offre pas d'outils pour vous aider à récupérer une disquette  endommagée).
  29.   AZap peut ouvrir plusieurs fenêtres d'édition en même temps  et  dispose  de
  30.   nombreuses fonctions, comme l'impression  d'un  bloc,  le  remplissage  d'un
  31.   bloc, la recherche d'une chaine, etc...
  32.  
  33.                    NOTE IMPORTANTE :
  34.  
  35.       Il est interdit de se servir  de    ce  programme  pour  modifier  des
  36.       indications de copyright, ou pour toute autre usage contraire  à    la
  37.       loi.  De    plus,  je  déconseille    vivement  aux    utilisateurs   non
  38.       expérimentés d'utiliser ce programme : vous risquez  de  rendre  des
  39.       programmes inutilisables,  ou  de  perdre  toutes  les  informations
  40.       stockées sur votre disque dur ! 
  41.  
  42.       Vos critiques et suggestions sur ce programme  seront  toujours  les
  43.   bienvenues. N'hésitez pas à m'écrire, à l'adresse suivante :
  44.  
  45.                    M. GOUNELLE Denis
  46.                     Boite 71
  47.                   6, rue des cailloux
  48.                  92110 CLICHY - FRANCE
  49.  
  50.       AZap utilise la  bibliothèque  "reqtools.library"  v2.0C,  que  vous
  51.   devez copier dans votre répertoire  "LIBS:",  si  ce  n'est  déjà  fait.  La
  52.   bibliothèque "reqtools.library" est (c)1990-1991 par Nico FRANCOIS.
  53.       Merci  à  Pierre  ARDICHVILI    et  à  Jean-Yves  PROUX   pour     leurs
  54.   suggestions.
  55.  
  56.   3. Appel depuis le CLI
  57.  
  58.       AZap se détache automatiquement du CLI. Les arguments acceptés  sont
  59.   les suivants :
  60.  
  61.       WBENCH
  62.       Normalement, AZap ouvre son propre écran. Cette option permet de
  63.       travailler sur l'écran Workbench.
  64.  
  65.       LACE
  66.       Si cette option est présente, AZap ouvre un écran  entrelacé    au
  67.       lieu d'un écran normal. Notez que cette option  est  ignorée  si
  68.       vous avez indiqué l'option WBENCH.
  69.  
  70.       FONT nom
  71.       Par défaut, AZap utilise une police interne de 6x9. Vous  pouvez
  72.       cependant demander à utiliser une autre police : "nom" doit être
  73.       sous la forme <nom de  la  police><taille  en  Y>  (par  exemple
  74.       "courier9"). AZap refusera si la police est proportionnelle,  ou
  75.       si elle est trop grande pour pouvoir afficher  un  bloc  de  512
  76.       octets.
  77.  
  78.       MEMORY
  79.       Au démarrage, AZap ouvre une fenêtre d'édition de la mémoire.
  80.  
  81.       DEVICE nom
  82.       Au démarrage, AZap ouvre  une  fenêtre  d'édition  pour  l'unité
  83.       "nom". N'oubliez pas les deux-points (":") à la fin du nom.
  84.  
  85.   Tout autre argument est considéré comme un nom de  fichier  à  ouvrir.  Vous
  86.   pouvez indiquer plusieurs noms de fichiers, mais  seuls  les    huit  premiers
  87.   seront pris en compte. Il est bien évidemment possible d'indiquer à la  fois
  88.   des noms de fichiers, l'option MEMORY, et l'option DEVICE. Si aucun argument
  89.   n'est indiqué, une requête  de  fichier  apparait  pour  que  vous  puissiez
  90.   sélectionner le fichier à éditer.
  91.  
  92.   4. Appel depuis le Workbench
  93.  
  94.       Vous pouvez indiquer les arguments suivants,    dans  le  champ  "TOOL
  95.   TYPES" de l'icône de AZap :
  96.  
  97.       OPTIONS=WBENCH ou OPTIONS=LACE
  98.       Voir description  des  options  WBENCH  et  LACE  au    paragraphe
  99.       précédent.
  100.  
  101.       FONT=nom
  102.       Voir description de l'option FONT au paragraphe précédent.
  103.  
  104.   Au démarrage, une  requête  de  fichier  apparait  pour  que    vous  puissiez
  105.   sélectionner le fichier à éditer.
  106.  
  107.   5. La fenêtre d'édition
  108.  
  109.       La partie gauche  de    l'affichage  montre  le  contenu  du  bloc  en
  110.   hexadécimal, par groupe de 4 octets. La partie droite montre l'équivalent en
  111.   caractères, les codes non imprimables étant remplacés par un point (".").
  112.       En bas et à droite sont affichées quelques informations :  l'adresse
  113.   du bloc (relative au début, en hexadécimal), le déplacement dans le bloc (en
  114.   hexadécimal), le numéro de bloc (relatif au début, en décimal), et  le  type
  115.   de bloc. Cette dernière information n'a de sens que quand  vous  éditez  une
  116.   unité DOS. Quand les données du bloc ont été modifiées, une étoile ("*") est
  117.   affichée à droite de la première ligne. Si la somme de contrôle du bloc  est
  118.   valide, le caractère "V" est affiché à droite de la seconde  ligne  (n'a  de
  119.   sens que quand vous éditez une unité DOS).
  120.  
  121.       A l'ouverture de la fenêtre, le permier  bloc  est  affiché,  et  le
  122.   curseur est positionné sur le premier caractère  de  la  partie  droite.  La
  123.   position correspondante dans l'autre partie est  montrée  par  un  affichage
  124.   dans une couleur différente. Vous pouvez vous déplacer à l'aide des  touches
  125.   du curseur. Pour  passer  de    la  partie  droite  à  la  partie  gauche  (et
  126.   inversement) utilisez la touche de tabulation. Vous  pouvez  également  vous
  127.   positionner n'importe où à l'aide de la souris. Pour modifier  les  données,
  128.   tapez simplement les nouvelles valeurs. Dans la  partie  gauche,  seuls  les
  129.   caractères "0" à "9", "a" à "f" et "A" à "F" sont acceptés.  AZap  garde  en
  130.   mémoire les 32 dernières modifications. Tant que vous n'avez pas  changé  de
  131.   bloc, vous pouvez annuler ces changements en sens inverse, à    l'aide  de  la
  132.   touche <ESC>. Les touches suivantes sont également reconnues :
  133.  
  134.       ctrl-haut      va en début de fichier
  135.       ctrl-bas      va en fin de fichier
  136.       ctrl-gauche      va au bloc précédent
  137.       ctrl-droit      va au bloc suivant
  138.       shift-haut      va sur la première ligne
  139.       shift-bas      va sur la dernière ligne
  140.       shift-gauche      va au début de la ligne
  141.       shift-droit      va en fin de ligne
  142.  
  143.       La rangée de boutons en  bas    de  la    fenêtre  offre    les  fonctions
  144.   suivantes (de gauche à droite) :  aller  au  premier  bloc,  aller  au  bloc
  145.   précédent, écriture des modifications,  aller  au  bloc  suivant,  aller  au
  146.   dernier bloc. Le bouton tout à droite  (GOTO)  provoque  l'apparition  d'une
  147.   boite de requête. Vous êtes alors invité à entrer une adresse, sous une  des
  148.   formes suivantes :
  149.  
  150.       nbr      saut à l'adresse 'nbr'
  151.       §nbr      saut au bloc 'nbr'
  152.       @nbr      saut à l'adresse contenue dans le long mot à l'adresse
  153.           'nbr' (utilisable seulement en édition de mémoire)
  154.       #nbr      saut à la zone mémoire numéro 'nbr' (utilisable
  155.           seulement en édition de mémoire)
  156.  
  157.   Dans tous les cas, 'nbr' est une expression entière,  dont  la  syntaxe  est
  158.   décrite plus loin. Notez que si vous changez de bloc    sans  sauvegarder  vos
  159.   modifications, elles seront perdues !
  160.  
  161.       Pour fermer la fenêtre d'édition, il vous suffit de cliquer sur  son
  162.   gadget de fermeture. Si le bloc a été modifié  mais  non  sauvé,  AZap  vous
  163.   demandera confirmation. Le programme    s'arrête  automatiquement  quand  vous
  164.   fermez la dernière fenêtre.
  165.  
  166.   6. Le menu "Projet"
  167.  
  168.       Ouvre fichier...
  169.       Permet d'éditer un fichier : une requête  de  fichier  apparait,
  170.       sélectionnez le fichier désiré. AZap    ouvre  alors  une  fenêtre
  171.       supplémentaire d'édition.
  172.  
  173.       Ouvre mémoire
  174.       Ouvre une fenêtre supplémentaire,  permettant  l'édition  de  la
  175.       mémoire.
  176.  
  177.       Ouvre unité
  178.       Un sous-menu vous permet de sélectionner l'unité à éditer.  AZap
  179.       ouvre alors une fenêtre supplémentaire d'édition.
  180.  
  181.       Palette...
  182.       Vous permet de modifier les couleurs de l'écran (une requête  de
  183.       couleur apparait).
  184.  
  185.       Sauve prefs
  186.       Vous permet de  sauvegarder  la  configuration  de  AZap  :  les
  187.       couleurs de l'écran et la police de caractères. Les  options  de
  188.       la fenêtre courante sont également  enregistrées  comme  options
  189.       par  défaut.    Le   nom   du    fichier   de   configuration   est
  190.       "S:AZap.Config".
  191.  
  192.       A propos...
  193.       Affiche des informations  sur  le  programme.  Appuyez  sur  une
  194.       touche ou cliquez dans la fenêtre pour la faire disparaître.
  195.  
  196.       Quitte
  197.       Termine  l'exécution  de  AZap.  Le  programme  vous   demandera
  198.       confirmation.
  199.  
  200.   7. Le menu "Edite"
  201.  
  202.       Annule
  203.       Relit  le  bloc  courant.  Ceci  permet  d'annuler  toutes   les
  204.       modifications, tant que vous ne les avez pas enregistrées.
  205.  
  206.       Reviens
  207.       Chaque fois que vous vous déplacez avec les  boutons    "aller  au
  208.       premier bloc", "aller au dernier bloc",  ou  "GOTO",  l'ancienne
  209.       position est conservée en mémoire, et cette commande vous permet
  210.       d'y revenir par la  suite.  L'ancienne  position  est  également
  211.       mémorisée dans ce cas, ce qui peut être utile si vous travaillez
  212.       toujours sur les deux mêmes blocs.
  213.  
  214.       Bloc suivant
  215.       Lorsque vous éditez une unité DOS, cette  commande  vous  permet
  216.       d'aller soit au premier bloc de données (si vous  êtes  sur  une
  217.       entête de fichier), soit au bloc suivant (si vous  êtes  sur  un
  218.       bloc de données d'une disquette en OFS).
  219.  
  220.       Bloc parent
  221.       Lorsque vous éditez une unité DOS et que le bloc courant est une
  222.       entête de fichier (ou un répertoire), cette commande vous permet
  223.       d'aller au bloc de type "répertoire" correspondant au répertoire
  224.       père de ce fichier (ou répertoire).
  225.  
  226.       Bloc racine
  227.       Lorsque vous éditez une unité DOS, cette commande vous permet de
  228.       vous positionner directement sur le bloc racine de cette  unité.
  229.  
  230.       Dans les trois cas précédents,  l'ancienne  position  est  mémorisée
  231.       afin que vous puissiez y revenir avec la commande "Reviens".
  232.  
  233.       Remplis bloc...
  234.       Vous permet de mettre tous les octets du bloc courant à la  même
  235.       valeur.  Une    boite  de  requête  apparait,  entrez  la   valeur
  236.       désirée : soit 'c' pour remplir avec le caractère "c",  soit  un
  237.       nombre qui indique le code ASCII du caractère (précédé par  "0x"
  238.       pour une valeur hexadécimale).
  239.  
  240.   8. Le menu "Outils"
  241.  
  242.       Infos
  243.       Affiche   les   caractéristiques   de   ce   que   vous   éditez
  244.       (fichier/mémoire/unité).
  245.  
  246.       Cherche...
  247.       Vous permet de commencer une recherche.  Une    boite  de  requête
  248.       apparaît,  entrez  la  valeur  à  chercher  :  soit  une  valeur
  249.       hexadécimale (précédée par "0x", attention à  donner  un  nombre
  250.       pair de chiffres),  soit  une  chaine  de  caractère    (recherche
  251.       ASCII). Pour chercher une chaine  commençant    par  "0x",  mettez
  252.       toute la chaine entre guillemets.
  253.  
  254.       Cherche texte...
  255.       Vous permet de chercher des suites  de  caractères  affichables.
  256.       Cela peut être utile par  exemple  pour  chercher  une  zone    de
  257.       textes. Une boite de requête apparaît, entrez le nombre  minimal
  258.       de caractères que doit  avoir  une  suite  pour  être  prise    en
  259.       compte. Une valeur inférieure à 4  n'est  en  général  pas  très
  260.       intéressante.
  261.  
  262.       Cherche suivant
  263.       Vous permet de poursuivre la recherche à partir de  la  position
  264.       courante.
  265.  
  266.       Dans les trois cas précédents, si la valeur que vous avez entrez est
  267.       trouvée,     AZap    se   positionne   automatiquement   à     l'endroit
  268.       correspondant. L'ancienne  position  est  mémorisée  afin  que  vous
  269.       puissiez    y  revenir  avec  la  commande    "Reviens".  Sinon  l'écran
  270.       "flashe". Il est possible d'interrompre la recherche,  et  AZap  est
  271.       capable de trouver une chaine à cheval sur deux blocs.
  272.  
  273.       Imprime...
  274.       Vous permet d'imprimer le bloc courant.  Une  boite  de  requête
  275.       apparait pour vous permettre éventuellement d'envoyez la  sortie
  276.       vers un fichier, plutôt que vers l'imprimante ("PRT:").
  277.  
  278.       Conversion
  279.       Fait apparaitre une fenêtre supplémentaire, avec quatre gadgets,
  280.       qui  vous  permet  d'effectuer  des  conversions  entre  nombres
  281.       binaires, décimaux, hexadécimaux et chaines de caractères. Toute
  282.       valeur saisie, c'est-à-dire une  expression  complête  pour  les
  283.       gadgets "BIN", "DEC", et "HEX" ou une chaine de caractères  pour
  284.       le gadget "ASC", est convertie dans les  autres  unitées.  Notez
  285.       que cette fenêtre ne bloque pas les fenêtres d'édition.
  286.  
  287.   9. Le menu "Options"
  288.  
  289.       Somme de contrôle
  290.       Vous permet d'indiquer à  AZap  quand  il  doit  recalculer  les
  291.       sommes de contrôle des blocs (ceci n'est pris en compte  que  si
  292.       vous éditez une unité).  Les    choix  sont  :    "Recalcule"  (AZap
  293.       recalcule la somme de contrôle pour *TOUS* les blocs), "Demande"
  294.       (AZap vous posera la question à chaque écriture), "Blocs 0 &  1"
  295.       (seulement pour le bloc d'amorçage) et "Automatique"  (seulement
  296.       si la somme de contrôle était correcte à la lecture).
  297.  
  298.       Sauveg. auto
  299.       AZap sauvegarde automatiquement tout bloc modifié dès  que  vous
  300.       demandez à changer de bloc.
  301.  
  302.       Lecture seule
  303.       AZap interdit toute modification des données.
  304.  
  305.       min = MAJ
  306.       Indique si les majuscules et les minuscules seront différenciées
  307.       ou non lors des recherches.
  308.  
  309.       Copie de sauveg.
  310.       Indique si AZap doit créer une copie de sauvegarde des  fichiers
  311.       édités.  Si  cette  option  est  sélectionnée,  à  la  prochaine
  312.       tentative d'écriture, une boite de requête apparaitra pour  vous
  313.       demander le nom de la copie à créer. AZap fera alors    une  copie
  314.       du  fichier,    avant  d'enregistrer  vos  modifications.  En  cas
  315.       d'erreur pendant la copie, la  boite  de  requête  réapparaitra,
  316.       pour vous permettre d'indiquer un autre nom. Si vous cliquez sur
  317.       "Cancel", aucune copie ne  sera  faite  mais  les  modifications
  318.       seront enregistrées quand même.
  319.  
  320.   10. Syntaxe des expressions
  321.  
  322.       AZap est capable de calculer des expressions entières. La  base  par
  323.   défaut est soit le décimal pour la saisie des adresses (gadget "GOTO")  soit
  324.   la base correspondant au gadget  pour  la  fenêtre  de  conversion.  Il  est
  325.   possible de préciser la base,  en  préfixant    un  nombre  par  "%"  pour  le
  326.   binaire, "#" pour le  décimal,  et  "$"  ou  "0x"  pour  l'hexadécimal.  Les
  327.   opérateurs connus sont :
  328.  
  329.       +      addition
  330.       -      soustraction
  331.       |      "ou" logique
  332.       &      "et" logique
  333.       *      multiplication
  334.       /      division entière
  335.       %      reste de la division entière
  336.       <      décalage à gauche
  337.       >      décalage à droite
  338.  
  339.   Normalement, les opérateurs "*", "/", "%", "<" et ">" sont plus prioritaires
  340.   que les autres, mais vous pouvez utiliser des parenthèses. En  cas  d'erreur
  341.   de syntaxe, le résultat d'une expression sera égal à -1.
  342.  
  343.   11. Remarques importantes
  344.  
  345.       Lors du démarrage du programme, AZap consulte la structure  ExecBase
  346.   pour connaitre votre configuration mémoire. Seules les zones indiquées  dans
  347.   les listes de gestion  de  mémoire  peuvent  être  éditées.  Sauf  lors  des
  348.   recherches,  AZap   considère   ces    zones    comme    contigües   et     passe
  349.   automatiquement de l'une à l'autre. Utilisez la  commande  "Infos"  du  menu
  350.   "Outils" pour avoir la liste des zones mémoires. Notez  que  la  lecture  et
  351.   l'écriture  des  blocs  mémoire  se  fait  après   blocage   temporaire   du
  352.   multi-tâches, afin d'éviter des conflits d'accès.
  353.  
  354.       Lorsque vous ouvrez une fenêtre d'édition sur une  unité,  AZap  est
  355.   capable de détecter son type. Certaines opérations  seront  impossibles  sur
  356.   une unité non AmigaDOS (commandes  "bloc  suivant",  "bloc  père"  et  "bloc
  357.   racine"), mais pensez à désactiver le recalcul de la somme de contrôle !  Le
  358.   programme sait reconnaitre le système de fichier utilisé  (OFS  =  Old  File
  359.   System, FFS = Fast File System) et gérer ces deux systèmes.
  360.  
  361.   12. Historique
  362.  
  363.       AZap est écrit en langage C, et compilé avec le SAS/C 5.10b, sur  un
  364.   A3000 UNIX-1 équipé de 6 Mo de mémoire, de 188 Mo de disque, de  2  lecteurs
  365.   de disquettes, et d'un  moniteur  1960.  Le  développement  de  la  première
  366.   version de ce programme a commencé le 08-Sep-92, et s'est terminé  après  50
  367.   heures de travail environ.
  368.  
  369.   v1.00   14-Oct-92, 36084 octets
  370.       o Première version diffusée
  371.  
  372.  
  373.  
  374.  
  375.  
  376.